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SCORING  RULE  SYSTEM  SPECIFICATION 


1.0  INTRODUCTION 


t 


C 


1.1  Purpose  of  the  System  Specification 

A 

The  Scoring  Rule  System  Specification  is  a  technical 
document  written  for  software  development  personnel.  To¬ 
gether  with  the  Scoring  Rule  Functional  Description,  it 
guides  the  software  development  effort  by  identifying  the 
functional  requirements  and  by  providing  structured  logic 
diagrams  that  depict  the  flow,  control,  and  processing  of 
information  within  the  system. 


The  Scoring  Rule  System  Specification  is  generic  and 
is  intended  to  guide  and  facilitate  the  preparation  of  the 
language- specific  program  documentation  and  coding  that  are 
necessary  to  implement  and  operate  Scoring  Rule  at  an  instal¬ 
lation.  ,/ 

\ 

1 . 2  References 


1.2.1  IBM,  HIPO— A  Design  Aid  and  Documentation  Tech 
nique .  Technical  Publication  GC20-1851-0. 

White  Plains,  New  York:  IBM,  October  1974. 

1.2.2  Amey,  Dorothy  M.;  Feuerwerger,  Phillip  H.; 
Gulick,  Roy  M.  Documentation  of  Decision- Aiding 
Software:  Scoring  Rule  Functional  Description. 
McLean,  Virginia:  Decisions  and  Designs,  Inc., 
July  1979. 
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1.2.3  Amey,  Dorothy  M. ;  Feuerwerger,  Phillip  H.; 
Gulick,  Roy  M.  Documentation  of  Dec is ion- Aiding 
Software:  Scoring  Rule  Users  Manual.  McLean, 
Virginia:  Decisions  and  Designs,  Inc.,  July 
1979. 

1.2.4  Brown,  Rex  V.;  Kahr,  Andrew  S.;  Peterson, 

Cameron  R.  Decision  Analysis  for  the  Manager. 
New  York:  Holt,  Rinehart  and  Winston,  1974. 

1. 3  Terms  and  Abbreviations 

1.3.1  Scoring  Rule  -  Scoring  Rule,  the  name  of  the 
system,  is  a  short  description  of  the  function  performed  by 
the  software,  reflecting  the  system's  method  for  testing, 
scoring,  and  training  probability  assessors. 

1.3.2  SCORE  -  SCORE,  an  abbreviation  for  Scoring  Rule, 
is  used  throughout  this  report  to  refer  to  the  system. 

1.3.3  Terms  -  Standard  mathematical  notations  are  used 
throughout  this  System  Specification.  Chapter  31  of  refer¬ 
ence  1.2.4  provides  additional  background  and  insight  into 
the  terms  and  basic  concepts  underlying  the  procedures 
implemented  by  SCORE. 
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2.0  DESIGN  DETAILS 


2.1  Background 

Systems  development  personnel  should  refer  to  the 
Scoring  Rule  Functional  Description ,  reference  1.2.2,  in 
conjunction  with  the  documentation  contained  in  this  speci¬ 
fication.  The  Functional  Description  details  the  testing 
procedure  implemented  by  the  software  and  discusses  the 
specific  functions  that  the  software  performs.  In  addition, 
systems  development  personnel  may  wish  to  refer  to  the 
Scoring  Rule  Users  Manual,  reference  1.2.3. 

2 . 2  General  Operating  Procedures 

SCORE  is  designed  to  interact  with  the  user  by  pre¬ 
senting  a  sequential  set  of  questions  and  alternative 
answers  and  asking  the  user  to  respond  by  selecting  the 
correct  answer  and  specifying  the  degree  of  certainty  in  the 
form  of  a  probability.  The  user  may  optionally  enter  com¬ 
mand  characters  (H,  F,  or  S)  which  will  allow  the  interrup¬ 
tion  of  the  question-answering  mode.  If  the  "H"  command  is 
entered,  the  system  will  return  a  list  of  available  commands 
and  an  explanation  of  their  use;  the  "F"  command  causes  the 
output  of  intermediate  results;  and  the  "S"  command  causes 
an  exit  from  the  system  prior  to  finishing  the  question  set. 

The  system  is  also  designed  to  be  generally  forgiving 
of  procedural  errors  by  the  user. 

2.3  System  Logical  Flow 

SCORE  is  a  hierarchically  structured,  modular  system. 
The  system  structure  and  logical  flow  lends  itself  to 


presentation  in  the  form  of  HIPO  diagrams,  which  are  con¬ 
tained  in  this  document. 

The  main  purpose  of  the  HIPO  diagrams  is  to  provide,  in 
a  pictorial  manner,  the  complete  set  of  modular  elements 
necessary  to  the  operation  of  SCORE  including  all  input, 
output,  and  internal  functional  processing.  This  is  done  by 
displaying  input  items  of  the  process  step  which  uses  them, 
defining  the  process,  and  showing  the  resulting  output  of 
the  process  step. 

The  documentation  diagrams  are  designed  and  drawn  in  a 
hierarchical  fashion  from  the  main  calling  routines  to  the 
detail-level  operation/calculation  routines.  Extended 
written  descriptions  are  given  below  a  HIPO  diagram  whenever 
it  is  deemed  necessary. 

A  complete  explanation  of  the  symbolic  notation  used  in 
the  HIPO  diagrams  is  given  in  reference  1.2.1.  An  abbre¬ 
viated  legend  for  the  symbols  used  in  this  specification  is 
given  in  Figure  2-1.  Note  that: 

a.  External  subroutines  appear  partly  in  the  process 
block  and  partly  out.  Internal  subroutines  are 
shown  within  the  process  block. 

b.  Overview  diagrams  show  general  inputs  and  outputs 
only,  whereas  detail/subroutine-level  diagrams 
show  specific  input/output  tables  and/or  displays. 

c.  Rectangular  boxes  inside  the  input/output  block 
areas  are  generally  used  to  denote  single  data 
items.  Two  or  more  boxes  are  grouped  to  show 
several  data  items  are  input/output. 
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d.  Rectangular  boxes  inside  the  process  block  indi¬ 
cate  repetitive  subprocesses. 

The  HIPO  diagrams  appear  in  the  next  section,  which 
completes  the  System  Specification. 

2 . 4  HIPO  Documentation 


The  HIPO  diagram  identification  numbers  and  figure 
numbers  used  in  this  section  stand  alone;  i.e. ,  they  start 
with  1.0,  increase  hierarchically,  and  are  independent  of 
the  number  scheme  used  to  this  point  in  this  document. 

Figure  2-2  is  a  system  structure  chart  and  represents 
the  overall  program  logic  flow  in  a  visual  table  of  con¬ 
tents.  The  visual  Table  of  Contents  diagram  shows  the 
hierarchical  structure,  the  functional  description  labels, 
and  the  diagram  (chart)  identifiers  of  functions  of  SCORE. 
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Extended  Description 

1-2.  The  user  is  prompted  for  the  beginning  and  ending  numbers  of  questions 
from  the  currently  selected  group  that  are  to  be  asked  during  the  program  session. 

3.  A  subgroup  of  questions  to  be  asked  is  determined  by  including  only  those 
location  indices  of  questions  between  (and  inclusive  of)  the  starting  and  ending 


ORE  Name:  _ 

_ rw.T«„».  Process  User  Commands _  Page. 


System  Program  SCORE _  Name  _  _ 

Diagram  ID  -&Q _ Description  Atk  0»«tions  gd.Sc, ore  Answers _  p,„„. 


Extended  Description 

3.  The  scores  for  questions  and  the  hit  records  are  computed  by  using  the  latest 
update  of  the  user's  response  to  answering  the  question  and  providing  a 
probability  assessment  for  the  correctness  of  the  given  answer. 


Description.  Reference  1.2.2. 


